…s flag

- component-governance-utils: add getChangedMdxFilesSince(ref) and files
  option on scanMDXImports for incremental MDX scans
- scan-component-imports: add --since <commit> incremental mode; narrows
  MDX scan to changed files while keeping full component inventory
- audit-component-usage: remove execSync/child_process; use getComponentFiles,
  extractExports, scanMDXImports from shared utils; fix REPORT_PATH to use
  REPO_ROOT instead of brittle __dirname traversal
- lint-structure: add --files path1,path2,... flag; priority order is
  LINT_FILE_LIST > --files > --changed-files > positional arg

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…ent branch

lint-structure.js is a content validator, not component governance tooling.
The --files flag addition belongs on docs-v2-dev directly.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

… restructure

- Fix 136 stale paths in script-classifications.json (111 remapped to
  new taxonomy locations, 8 remapped to x-archive, 17 deleted entries)
- Add 21 missing classification rows for new and split scripts
- Regenerate scripts-catalog.mdx, pages-catalog.mdx, and all
  group script-index.md files
- Fix stale spawn path in export-portable-skills.test.js
- Fix stale component path in authoring-tools.test.js (quote.jsx moved)
- Fix stale generate-ai-skills-indexes.js path in ai-tools-registry.json
- Fix 4 stale artifact paths in ai-tools-registry.json (files moved
  to _workspace/ in latest docs-v2-dev merge)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Add missing @param className/style to all 22 component exports that
destructure those props without JSDoc entries. Fix EmbedMarkdown JSDoc
detection (archived comment was breaking block parse). Add @SubNiche
to MermaidColours. Fix OPTIONAL_GOVERNANCE_FIELDS not being mapped onto
parsed JSDoc object (causing false @Datasource warnings on all integrators).
0 violations on generate-component-registry.js --strict.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Replace __dirname traversal with process.cwd()/git rev-parse REPO_ROOT
  in 6 scripts: audit-component-usage, terminology-search, generate-glossary,
  generate-seo, test-v2-pages, lint-copy
- Extract magic string 'tools/scripts' to SCRIPTS_ROOT constant in
  script-footprint-and-usage-audit.js
- Extract buried path constant RETENTION_POLICY_PATH to config block
  in quarantine-manager.js
- Extract hardcoded audit-script-inventory.js path to AUDIT_SCRIPT
  constant in repair-script-inventory.js
- Extract V2_ROOT constant in generate-seo.js; replace all /v2/ magic
  strings with template literals
- Add Task 13 (script docs consolidation analysis) to plan.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Analysis of all current script documentation surfaces, problems
identified (schema drift, duplication, no single source of truth),
and proposed architecture for Task 13 execution.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…solidation recommendations

54 surfaces audited across 6 categories. Proposes script-registry.json as
single source of truth, script-governance.mdx on nav, and JSON→MDX
aggregation pattern for both scripts and components.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

TL;DR: one JSON registry per domain → everything generated from it,
plus one spec page on the nav. Includes decisions needed, execution
order, and blockers (27 mistyped @type values, missing component registry).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Architecture decision report and full 54-surface audit for script
documentation consolidation. One JSON registry, one spec on nav.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

docs-guide-sot.test.js and run-all.js still referenced old flat script
paths under tools/scripts/. Update all to match Task 9 reorganisation:
  generate-docs-guide-*.js  → generators/governance/catalogs/
  generate-ui-templates.js  → generators/components/library/
  audit-component-usage.js  → audits/components/documentation/
  generate-component-docs.js → generators/components/documentation/

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Moves the extension reference page to docs-guide/tooling/ and registers
it in the Tooling navigation group in docs.json. Adds a Future Features
section documenting Mermaid lazy-loading, component promotion, syntax
highlighting, scroll sync, and hot-reload improvements.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…lan, @type fix

- plan.md: strike through completed tasks 1, 11, 11a-f, 12, 12c, 13.1-13.4
- doc-recommendation.md: add MDX-in-MDX opportunity, spec accuracy section,
  locale mirrors (3 mirrors confirmed: cn/es/fr), Q4+Q5 decisions, correct
  @type count from 27→1 remaining (fixed), update execution order
- task-13-subplan.md: full execution sub-plan for T13 with steps, risks,
  file list, and Q1-Q5 approval table
- update-jsdoc-headers.js: add proper 11-tag JSDoc header with @type remediator

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Mermaid.js (2.45 MB) is now only injected when the page contains at
least one mermaid segment. Pages without diagrams skip the bundle.

Component hot-reload: saving any .jsx file in the workspace now
triggers a re-render of all open preview panels.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Task 13b: auto-generated file governance — extend banner enforcement
  to non-MDX files (.md indexes, .json registries) + AI-explicit callout
- Task 13c: tasks/ → workspace/ rename before Task 14; sub-plan created
  at task-13c-workspace-rename-subplan.md with full audit, risk register,
  step-by-step execution
- Task 13d: lpd-cli audit + governance + docs recommendations
- Execution summary table updated with 13, 13b, 13c, 13d

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- tasks/plan/active/index.md: comprehensive index of all 9 active governance
  plans + content frameworks + published policies + frameworks, with per-section
  summaries and file tables
- autogenerated-file-governance.md: Task 13b full implementation recommendation
  — HTML comments for .md, _generated key for .json, AI-AGENT line in MDX
  hidden banner, extend generated-artifacts.json + enforce-generated-file-banners.js

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Add component-docs.md: Task 10 pre-flight architecture audit covering
  all 12 documentation surfaces, taxonomy divergence, 14 vs 7 field
  schema problem, and recommended SOT architecture
- Refresh component-usage-map.json from latest scan post-Task-8 fixes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Fix fabricated import paths across 59 files
- Restore SearchTable.jsx component imports
- Remove unauthorised CDN asset contract system
- Restore inline CDN URLs in 8 consumer files
- Fix duplicate frontmatter keys in 6 About pages
- Fix multi-view-layout.mdx broken JSX comment syntax
- Fix 5 gateway custom composable imports
- Remove moved x-deprecated files from docs.json nav

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
allow-deletions: true

allow-deletions: true

# Conflicts:
#	operations/reports/health/page-imports/page-imports-audit.json
#	operations/reports/health/page-imports/page-imports-audit.md
#	snippets/templates/pages/gold-standard/multi-view-layout.mdx
#	v2/about/concepts/core-concepts.mdx
#	v2/about/network/overview.mdx
#	v2/about/protocol/design-philosophy.mdx
#	v2/about/protocol/economics.mdx
#	v2/about/resources/reference/technical-roadmap.mdx
#	v2/gateways/custom/views/quickstart/docker/dockerOffChainTab.mdx
#	v2/gateways/custom/views/quickstart/docker/dockerOnChainTab.mdx
#	v2/gateways/quickstart/views/docker/dockerOffChainTab.mdx
#	v2/gateways/quickstart/views/docker/dockerOnChainTab.mdx
#	v2/home/mission-control.mdx
#	workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/core-concepts.mdx
#	workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/design-philosophy.mdx
#	workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/economics.mdx
#	workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/economics2.mdx
#	workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/network-overview.mdx
#	workspace/plan/active/_MY_PROCESS/00_AUDIENCE-JOURNEY/ALL-CURRENT-INFORMATION/RESEARCH/ABOUT/claude-web-output/technical-roadmap.mdx

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…ate-assets-to-branch]

allow-deletions: true

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Fix fabricated import paths across all files
- Remove unauthorised CDN asset contract system
- Restore SearchTable.jsx component imports
- Fix gateway custom composable imports
- Remove stale docs.json nav refs
- Restore the-lott-hero-video.mp4 from merge base

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
allow-deletions: true

allow-deletions: true

# Conflicts:
#	docs.json
#	workspace/plan/active/_Project-Management_/completion-reports.md
#	workspace/thread-outputs/sessions/session-log.txt